home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Libraries / stdwin / Doc / man / dpv.man next >
Encoding:
Text File  |  1989-01-17  |  3.4 KB  |  114 lines  |  [TEXT/????]
  1. .TH DPV 1
  2. .SH NAME
  3. dpv \- ditroff output previewer
  4. .SH SYNOPSIS
  5. .B dpv
  6. [
  7. .B \-d
  8. ]
  9. [
  10. .BI + page
  11. ]
  12. .I file
  13. .SH DESCRIPTION
  14. .I Dpv
  15. is a previewer for
  16. .IR ditroff (1)
  17. output.
  18. There must be exactly one file argument, specifying a file produced by
  19. ditroff.
  20. The
  21. .B \-d
  22. option turns some debugging output on (if compiled in).
  23. The
  24. .BI + page
  25. option selects the initial page to display (default 1).
  26. .SH MENUS
  27. There are two menus.
  28. The
  29. .B Control
  30. menu contains commands to move around in the file, and a Quit command to
  31. leave the program.
  32. The
  33. .B Print
  34. menu contains commands to spool the file to various printers queues.
  35. Some checks are made that the file is compatible with the printer.
  36. .SH KEYBOARD CONTROL
  37. The following characters typed at the keyboard are interpreted as commands.
  38. A number
  39. .I N
  40. followed by a Carriage Return moves to page
  41. .I N.
  42. Carriage Return without preceding number moves one page forward.
  43. `.' with preceding number is equivalent to Carriage Return;
  44. without preceding number it redraws the current page.
  45. `N' moves to the next page, `P' moves to the previous page.
  46. A number
  47. .I N
  48. followed by `N' or `P' moves
  49. .I N
  50. pages forward or backward.
  51. Up arrow and backspace are equivalent to `P';
  52. `+', down arrow and space are equivalent to `N'.
  53. `-' is a toggle: it jumps to the previous page that was shown.
  54. `^' or `F' moves to the first page; `$' or `L' to the last.
  55. `G' without preceding number also moves to the last page;
  56. with a preceding number
  57. .I N
  58. it moves to page
  59. .I N.
  60. `Q' quits from the program.
  61. Lower case letters are equivalent to their upper case counterparts.
  62. .SH DIAGNOSTICS
  63. Complaints about missing files, unknown fonts and what have you are
  64. written to stderr.
  65. .SH FILES
  66. funnytab, /usr/local/lib/funnytab, /userfs3/amoeba/lib/funnytab
  67. \- funny character translation table search path
  68. .SH SEE ALSO
  69. ditroff(1)
  70. .SH AUTHOR
  71. Guido van Rossum
  72. .SH BUGS
  73. May crash on malformed input (not generated by ditroff).
  74. .br
  75. Arcs and splines are replaced by straight lines (because I don't have
  76. the necessary mathematics at hand), so output from
  77. .IR pic (1)
  78. or other graphics preprocessors may be unrecognizable.
  79. .br
  80. Doesn't know all funny characters.
  81. Unknown characters are silently suppressed.
  82. .br
  83. Doesn't know all fonts, or all sizes.
  84. Unknown fonts and sizes are replaced by known ones.
  85. .br
  86. The current X11 version uses Adobe bitmap fonts which don't match very
  87. well with the width tables for the Harris.
  88. .br
  89. Character and line spacing are scaled, but it believes that it should
  90. use characters in the point sizes specified in the input.
  91. This may cause the output to look a bit cramped.
  92. .br
  93. It assumes page numbers always start at 1; it doesn't know about the
  94. true page numbers (even though these are present in the ditroff output).
  95. .br
  96. There should be an argument to specify an alternate funny character
  97. translation table file.
  98. .br
  99. The font translation table should be read from a file as well.
  100. .br
  101. If it can't find the funny character translation table file, it should
  102. fall back on a reasonable default.
  103. .br
  104. The Print menu is very CWI-specific; it, too should be customizable
  105. instead of being wired in.
  106. .br
  107. Errors in the input are handled ungracefully.
  108. .br
  109. STDWIN prints a warning to stderr for every font change if a font in the
  110. translation table doesn't exist (e.g., if you are using the X11 Release
  111. 3 version of dpv with a Release 2 server, or vice versa; or if you have
  112. botched your font directory or font path).  needless to say this can be
  113. annoying.
  114.